<?php
Bxd::getInstance()->lib('db')->loadClass("DbConn");

/**
 * The MIT License
 *
 * Copyright (c) <year> <copyright holders>
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 *
 * Classe base per l'esecuzione delle query e l'interfacciamento con i metodi disponibili in PDO.
 * Possono essere eseguite le query in due modalità:
 *
 * execute() | prepare() : La differenza tra i due metodi è la possibilità di eseguire o meno il bind dei parametri
 *
 * @author Damiano Ciarla
 * @package lib
 * @subpackage db
 */
class BXDDb extends BXDDbConn
{
	private static $instance;

	/**
	 * Metodo che restituisce un istanza della classe BXDDb se questa non è già stata istanziata
	 *
	 * @param BXDDbConfig $dbConf Istanza della classe BXDDbConfig con i valori settati per aprire la connessione al database
	 *
	 * @return BXDDb
	 */
	public static function getInstance(BXDDbConfig $dbConf = null)
	{
		if (self::$instance === null)
			self::$instance = new BXDDb($dbConf);

		return self::$instance;
	}

	/**
	 * Nuova istanza della classe BXDDb avente i metodi base per l'esecuzione delle query e
	 * l'interfacciamento con i metodi disponibili in PDO
	 *
	 * @param BXDDbConfig $dbConf Istanza della classe BXDDbConfig con i valori settati per aprire la connessione al database
	 */
	public function __construct(BXDDbConfig $dbConf = null)
	{
		parent::__construct($dbConf);
		self::$instance = $this;
	}

	/**
	 * Apertura della transazione
	 */
	public function beginTransaction()
	{
		$this->getConnection()->beginTransaction();
	}

	/**
	 * Chiusura della transazione con salvataggio persistente dei dati
	 */
	public function commit()
	{
		$this->getConnection()->commit();
	}

	/**
	 * Chiusura della transazione con annullamento di tutte le operazione eseguite al suo interno
	 */
	public function rollBack()
	{
		$this->getConnection()->rollBack();
	}

	/**
	 * Restituzione dell'ultimo ID inserito
	 *
	 * @return int Ultimo id inserito
	 */
	public function lastInsertId()
	{
		return intval($this->getConnection()->lastInsertId());
	}

	/**
	 * Esegue una query con la connessione di default
	 *
	 * <code>
	 * $BXDDb->execute("SELECT * FROM user WHERE first_name = ? AND id > ?", array("John", 1))
	 * ->fetchAll(PDO::FETCH_ASSOC);
	 * </code>
	 *
	 * @param string $sql Query sql con eventuali parametri di bindare specificati con '?'
	 * @param array $params Array di parametri
	 *
	 * @return BXDDbResult
	 */
	public function execute($sql, $params = null)
	{
		$countSqlParams = substr_count($sql, "?");

		if($countSqlParams > 0 && ($params === null || count($params) < $countSqlParams))
			throw new BXDDbException($sql, BXDDbException::INSUFFICENT_PARAMS);

		$sth = $this->getConnection()->prepare($sql);

		try
		{
			$sth->execute((($params !== null) ? $params : null));

			Bxd::getInstance()->lib('db')->loadClass("DbResult");

			return new BXDDbResult($sth);
		}
		catch(PDOException $e)
		{
			throw new BXDDbException($e->getMessage(), BXDDbException::INVALID_SQL_QUERY);
		}
	}

	/**
	 * Esegue una query sulla connessione di default utilizzando il bind dei parametri
	 *
	 * <code>
	 * $BXDDb->prepare("SELECT * FROM user WHERE first_name = :first_name AND id > :id")
	 * ->bindParam("first_name", "John")
	 * ->bindParam("id", 1)
	 * ->execute()
	 * ->fetchAll(PDO::FETCH_ASSOC);
	 * </code>
	 *
	 * @param string $sql Query sql con eventuali parametri di bindare specificati tramite (?|:nome_parametro)
	 *
	 * @return BXDDbPrepare
	 */
	public function prepare($sql)
	{
		$sth = $this->getConnection()->prepare($sql);

		Bxd::getInstance()->lib('db')->loadClass("DbPrepare");
		
		return new BXDDbPrepare($sth);
	}
}
?>
